SpeechSynthesis: Methode getVoices()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2018.

Die getVoices()-Methode des SpeechSynthesis-Interfaces gibt eine Liste von SpeechSynthesisVoice-Objekten zurück, die alle verfügbaren Stimmen auf dem aktuellen Gerät repräsentieren.

Syntax

js
getVoices()

Parameter

Keine.

Rückgabewert

Eine Liste (Array) von SpeechSynthesisVoice-Objekten.

Beispiele

JavaScript

js
function populateVoiceList() {
  if (typeof speechSynthesis === "undefined") {
    return;
  }

  const voices = speechSynthesis.getVoices();

  for (const voice of voices) {
    const option = document.createElement("option");
    option.textContent = `${voice.name} (${voice.lang})`;

    if (voice.default) {
      option.textContent += " — DEFAULT";
    }

    option.setAttribute("data-lang", voice.lang);
    option.setAttribute("data-name", voice.name);
    document.getElementById("voiceSelect").appendChild(option);
  }
}

populateVoiceList();
if (
  typeof speechSynthesis !== "undefined" &&
  speechSynthesis.onvoiceschanged !== undefined
) {
  speechSynthesis.onvoiceschanged = populateVoiceList;
}

HTML

html
<select id="voiceSelect"></select>

Spezifikationen

Specification
Web Speech API
# dom-speechsynthesis-getvoices

Browser-Kompatibilität

Siehe auch